home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer)…68k, x86, SPARC, PA-RISC] / NeXTSTEP 3.3 Dev Intel.iso / NextLibrary / Documentation / Sybase / DBLIB / Section3 / open_commit.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.5 KB  |  44 lines
  1. .Na "open_commit" 
  2. .Aa
  3. .Fu
  4. Establish a connection with the commit service.
  5. .Ih "commit service, establishing connection to"
  6. .Sy
  7. .Sf "DBPROCESS *open_commit(login, servername)"
  8. .Sp "LOGINREC" "*login"
  9. .Sp "char" "*servername"
  10. .Co
  11. .Bl
  12. This routine calls \f2dbopen()\fP to establish a connection 
  13. with the commit service. 
  14. A call to \f2open_commit()\fP
  15. must precede any calls to other commit service routines, such as
  16. \f2start_xact()\fP, \f2commit_xact()\fP,  \f2abort_xact()\fP, \f2remove_xact()\fP,
  17. and \f2scan_xact()\fP. A session with the commit service is closed
  18. by calling \f2close_commit()\fP.
  19. .Bl
  20. This routine returns a DBPROCESS structure, which is used to communicate
  21. with the commit service.
  22. The DBPROCESS must be dedicated to its role with the commit service
  23. and should not be used otherwise in the distributed transaction.
  24. .Bz
  25. .Pa
  26. .Pi login
  27. This is a LOGINREC containing information about the user 
  28. initiating the session, such as login name, password, options desired.
  29. The LOGINREC must have been obtained from a prior call 
  30. to the \*L routine \f2dblogin()\fP. The caller may wish to initialize
  31. fields in the LOGINREC. See the manual page for \f2dblogin()\fP for more details.
  32. .Pi servername
  33. The name of the commit service; for example, DSCOMMIT_SALESNET.
  34. If \f2servername\fP is NULL, the name DSCOMMIT is used. 
  35. The name cannot contain a period (``.'') or a colon (``:'').
  36. .in -.375i
  37. .Re
  38. .br
  39. A pointer to a DBPROCESS structure to be used in subsequent commit service calls,
  40. or NULL if the open failed.
  41. .Sa
  42. dblogin,
  43. dbopen
  44.